﻿<!DOCTYPE HTML>
<html lang="zh">
<head>
<title>获取文件属性 - 语法 &amp; 使用 | AutoHotkey v2</title>
<meta name="description" content="The 获取文件属性 function reports whether a file or folder is read-only, hidden, etc." />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
<script type="text/javascript">$(function(){0<=window.navigator.userAgent.toLowerCase().indexOf("ucbrowser")&&CaoNiMaDeUc()})</script>
</head>
<body>

<h1>获取文件属性</h1>

<p>报告文件或文件夹是否为只读, 隐藏等.</p>

<pre class="Syntax">AttributeString := <span class="func">获取文件属性</span>(<span class="optional">Filename</span>)</pre>
<h2 id="Parameters">参数</h2>
<dl>

  <dt>Filename</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
    <p>目标文件名, 如果未指定绝对路径则假定在 <a href="../Variables.htm#WorkingDir">内_工作目录</a> 中. 如果省略, 则使用最内层<a href="LoopFiles.htm">文件循环</a>的当前文件. 与 <a href="FileExist.htm">文件是否存在</a> 和 <a href="DirExist.htm">目录属性</a> 不同, 这必须是一个真正的文件名, 而不是一个模式.</p>
  </dd>

</dl>

<h2 id="Return_Value">返回值</h2>
<p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
<p>函数返回文件或文件夹的属性. 这个字符串是 <code>RASHNDOCT</code>, 的子集, 其中每个字母的意思如下:</p>
<ul>
    <li>R = READONLY(只读)</li>
    <li>A = ARCHIVE(存档)</li>
    <li>S = SYSTEM(系统)</li>
    <li>H = HIDDEN(隐藏)</li>
    <li>N = NORMAL(普通)</li>
    <li>D = DIRECTORY(目录)</li>
    <li>O = OFFLINE(离线)</li>
    <li>C = COMPRESSED(压缩)</li>
    <li>T = TEMPORARY(临时)</li>
</ul>
<p>如果没有找到文件或文件夹, 则返回空字符串.</p>

<h2 id="Error_Handling">错误处理</h2>
<p>失败时抛出异常.</p>
<p><a href="../Variables.htm#LastError">内_错误代码</a> 被设置为操作系统 GetLastError() 函数返回的结果.</p>

<h2 id="Remarks">备注</h2>
<p>另外, 要检索文件的 8.3 短名称, 请遵循以下示例:</p>
<pre><a href="LoopFiles.htm">遍历文件</a>, "C:\My Documents\Address List.txt"
    ShortPathName := 内_遍历文件短路径  <em>; 将产生类似于 C:\MYDOCU~1\ADDRES~1.txt 的路径</em></pre>
<p>可以使用类似的方法获得 8.3 短名称对应的长名称.</p>
<h2 id="Related">相关</h2>
<p><a href="FileExist.htm">文件是否存在</a>, <a href="DirExist.htm">目录属性</a>, <a href="FileSetAttrib.htm">文件设置属性</a>, <a href="FileGetTime.htm">获取文件时间</a>, <a href="FileSetTime.htm">文件设置时间</a>, <a href="FileGetSize.htm">获取文件大小</a>, <a href="FileGetVersion.htm">获取文件版本</a>, <a href="LoopFiles.htm">File-loop</a></p>

<h2 id="Examples">示例</h2>
<div class="ex" id="ExBasic">
<p><a href="#ExBasic">#1</a></p>
<pre>OutputVar := 获取文件属性("C:\New Folder")</pre>
</div>

<div class="ex" id="ExIf">
<p><a href="#ExIf">#2</a>: 检查检索的字符串中是否存在特定的属性(隐藏属性).</p>
<pre>如果 查找(获取文件属性("C:\My File.txt"), "H")
    信息框 "The file is hidden."</pre>
</div>

</body>
</html>